home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / kutsgl10.zip / KUTSGLUE.DOC < prev    next >
Text File  |  1990-03-02  |  42KB  |  923 lines
  1.                   KUTSGLUE cuts and glues text to your w.p.
  2.  
  3.           version 1.0 (c) copy right 1990 All Rights Reserved
  4.  
  5.           Have you wondered why your cut and paste USELESS GARBAGE
  6.           utility cannot cut right jagged USELESS GARBAGE
  7.           text like this? USELESS GARBAGE
  8.           Or why it only works on 25 rows only, and not 43 or 50 rows?
  9.           Or why it works under editor X but not under your word 
  10.           processor Y with the macro feature?  Or why can't it cut 
  11.           several texts?  Or conversely, why can't only selected parts 
  12.           of what was cut, be pasted to your word processor at a time?
  13.  
  14.           KUTSGLUE can cut right jagged text up to 50 rows, and glue 
  15.           it to your word processor, even if you have a macro key 
  16.           utility also running.  You can cut multiple texts and glue 
  17.           back selected parts (or all, of course) at a time.  KUTSGLUE
  18.           can be set to store up to 40,000 bytes of text, but since 
  19.           the text uses only as much space as you cut right jagged 
  20.           side, it can hold a lot.
  21.  
  22.           If you have a macro key utility, end the menu for gluing by
  23.           pressing down on the space bar.  Keep pressing on the space
  24.           bar and the text will be sent to your word processor.  If
  25.           there is no macro key utility, end the gluing w/<ntr>. 
  26.  
  27.           Your word processor, data base etc where you glue the text 
  28.           must be in insert or exchange or overlay mode, not in a 
  29.           command mode.
  30.  
  31.           The easiest way to use this document is to run KUTSGLUE 
  32.           using the default Run parameter and rapidly skimming through 
  33.           this document with your word processor or editor, 
  34.           occasionally using altM to pop up the KUTSGLUE menu.
  35.  
  36.           The set up of this document is as follows:
  37.  
  38.           Explanations of various in-line command parameters.
  39.           How KUTSGLUE works.
  40.           Chat.
  41.           Prompts and messages generated by KUTSGLUE.
  42.           Disclaimer, contribution $/address, info for sysops and 
  43.                shareware distributors.
  44.  
  45.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  46.                           IN-LINE COMMAND PARAMETERS
  47.           KUTSGLUE parameters<ntr>            explanations
  48.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  49.                                   HELP
  50.  
  51.           If you simply type
  52.  
  53.           KUTSGLUE<ntr>
  54.  
  55.           then you get the help screen only.  KUTSGLUE will not
  56.           become memory resident.
  57.  
  58.           The "<ntr>" is our way of saying <CR>, ^M, ^13, <ENTER>, 
  59.           carriage return, <ENTER> etc which all mean the same thing.
  60.           We also use <bks> for backspace, <esc> for the escape key, 
  61.           and "any key" to mean any function key, cursor key, letters, 
  62.           etc etc.  There is no one key with the word "any", but we 
  63.           may use <spc> to mean the big space bar.
  64.  
  65.           In case you're wondering about the wastefulness of storing
  66.           such mini-helps in the program, this and many other
  67.           messages stored in KUTSGLUE do not occupy any space when 
  68.           memory resident.
  69.  
  70.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  71.                             RUN WITH DEFAULTS
  72.  
  73.           To run this, simply type
  74.  
  75.           KUTSGLUE RUN<ntr>
  76.  
  77.           and end it with an <ENTER> or <ntr> or <cr> or anything
  78.           else you want to call the carriage return.  This document 
  79.           and all documents by my group uses the "<ntr>" format.
  80.           Just the letter "r" in "run" will work also.
  81.  
  82.           Unless specified otherwise, the use of capital or small 
  83.           letters is identical.
  84.  
  85.           Any other command or text after the Run parameter is 
  86.           ignored.  The Run parameter is used when you run KUTSGLUE
  87.           without setting any other parameter.  In other words, if you 
  88.           want to run this with the built-in defaults.
  89.  
  90.           If you run this program from within AUTOEXEC.BAT, the text 
  91.           after the Run parameter will act as a comment describing 
  92.           what you are doing.  For example
  93.  
  94.           KUTSGLUE A1<ntr>
  95.  
  96.           will run this with the pop up menu in blue on black 
  97.           background (Attribute color 1, if you use a color monitor), 
  98.           so it is not necessary to type
  99.  
  100.           KUTSGLUE A1 RUN<ntr>
  101.  
  102.           since you are not running with only defaults, but since 
  103.           everything after the Run parameter is ignored, you can 
  104.           comment your AUTOEXEC.BAT file as in
  105.  
  106.           KUTSGLUE A1 RUN w/blue character on black back<ntr>
  107.  
  108.           On the other hand,
  109.  
  110.           KUTSGLUE RUN A1<ntr>
  111.  
  112.           will accept the "A1" as merely a comment.
  113.  
  114.           --------------------------------------------------------------
  115.           KUTSGLUE itself and all programs hence forth lost the
  116.           self-wipe feature, the ability to wipe any and all other
  117.           memory resident programs loaded after this program.
  118.                        (unless I start hearing otherwise)
  119.           --------------------------------------------------------------
  120.  
  121.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  122.                        CHANGING THE POP UP HOT KEY
  123.  
  124.           If you don't want to use the default altM key combination to 
  125.           pop up the menu, then you have a choice of a few hundred 
  126.           others to choose from.
  127.  
  128.           The allowed key combinations are function keys, cursor keys, 
  129.           ctrl/shift/alt with function keys, alt with letters or 
  130.           numbers, etc.  But these are probably used by your word 
  131.           processor or other softwares.  In that case, you can choose 
  132.           the combination made of pressing down on the alt key and 
  133.           while keeping it pressed, typing the numbers "1" through 
  134.           "255" on the numeric keypad to the right side of the regular 
  135.           keyboard.  This is normally used to enter chr$(128) through 
  136.           chr$(255) into word processors which allow the use of 
  137.           extended ascii characters.
  138.  
  139.           To find what command parameter you need to make any of these 
  140.           combinations act as the new menu hot key, type
  141.  
  142.           KUTSGLUE M<ntr>
  143.  
  144.           This will ask you to type any valid key combination which 
  145.           can be used as a new menu hot key.  If you press down on the 
  146.           altM key combination at this time, then it responds with a
  147.  
  148.           you need
  149.           M 50,000
  150.  
  151.           and if you enter the command parameter
  152.  
  153.           KUTSGLUE M50,000<ntr>
  154.  
  155.           then altM will act as the menu's pop up hot key combination 
  156.           as is the default.
  157.  
  158.           If you pressed down on the alt+ combination, then it tells 
  159.           you that you need
  160.  
  161.           KUTSGLUE M131,000<ntr>
  162.  
  163.           to make alt+ the menu's pop up hot key.
  164.  
  165.                As you can see, to make altM, alt-, control-F1 and 
  166.                other keys into the new menu hot key, numbers are 
  167.                followed by three zeros.
  168.  
  169.           At the prompt, if you pressed down on the alt key and while
  170.           keeping it pressed down, you type "22" on the numeric
  171.           keypad on the right side of the keyboard before letting go
  172.           of the alt key, then it tells you to use "M 22", so
  173.  
  174.           KUTSGLUE M22<ntr>
  175.  
  176.           will make this the new hot key for the menu.  In other 
  177.           words, press down on the alt key and while keeping it 
  178.           pressed down, type "22" on the numeric key pad to make the 
  179.           menu pop up. (You cannot type "22" on the regular keyboard 
  180.           above the letters "QW".  It does not work.)
  181.  
  182.           KUTSGLUE ignores the comma "," and counts the number only.
  183.           The comma is only for your reference, so
  184.  
  185.           KUTSGLUE M131000<ntr>
  186.  
  187.           will also make alt+ the new hot key.  But
  188.  
  189.           KUTSGLUE M131 000<ntr>
  190.  
  191.           will not work since KUTSGLUE accepts the space between the
  192.